home *** CD-ROM | disk | FTP | other *** search
/ Aminet 50 / Aminet 50 (2002)(GTI - Schatztruhe)[!][Aug 2002].iso / Aminet / util / arc / nulib2.lha / nulib2-101 / nulib2.man < prev    next >
Text File  |  2002-01-03  |  6KB  |  199 lines
  1.  
  2.  
  3. NULIB2 (1L)                   17 Jan 2000                    NULIB2 (1L)
  4.  
  5.  
  6.  
  7.  
  8. NAME  
  9.         nulib2 - package and compress (archive) files 
  10.  
  11. SYNOPSIS  
  12.         ›1mnulib2›m   ›m-command[modifiers]›1m›m›1m›m›1m›m  ›3marchive›m
  13.         ›3m[›mfilenames 
  14.  
  15. DESCRIPTION  
  16.         ›3mnulib2›m is a disk and  file  archiver  for  NuFX  (ShrinkIt)
  17.         files.    It   can   add   files   to  and  extract  files  from
  18.         ›3m.SHK›m,›3m›m›3m›m  ›3m.BXY›m,›3m›m›3m›m   ›3m.SEA›m›3m›m›3m›m
  19.         (as created by GS/ShrinkIt), and ›3m.BSE›m files.  
  20.  
  21.         When extracting, testing, or listing the contents of an archive, 
  22.         you can  specify  "-" for the archive name.  The archive will be
  23.         read from stdin.  
  24.  
  25.         Filenames are considered case-sensitive.  
  26.  
  27.         This man page contains a summary of available options.  For full 
  28.         documentation     and     the     latest     versions,     visit
  29.         http://www.nulib.com/.  
  30.  
  31. OPTIONS  
  32.  
  33.         ›1m-a›m Add files to an archive.  If the archive does not exist, 
  34.         a new  one  will  be  created.  The list of files to add must be
  35.         given.  
  36.  
  37.         ›1m-d›m Delete files from an archive.    The  set  of  files  to
  38.         delete must be provided.  
  39.  
  40.         ›1m-i›m Integrity  test.    If no files are listed, all files in
  41.         the archive are tested.  
  42.  
  43.         ›1m-p›m Pipe extraction.  All extracted  files  are  written  to
  44.         stdout instead  of  a  file  on  disk.   Normal archive progress
  45.         messages are suppressed.  
  46.  
  47.         ›1m-t›m Table of contents.  Provides a simple list of  files  in
  48.         the archive, one per line.  
  49.  
  50.         ›1m-v›m Verbose  table  of  contents.    Output  similar to what
  51.         ShrinkIt displays is shown.  
  52.  
  53.         ›1m-x›m Extract files from an archive.  If no files are  listed,
  54.         all files in the archive are extracted.  
  55.  
  56. MODIFIERS  
  57.  
  58.         ›1m-0›m Don't  use  compression.    Files  added  will be stored
  59.         without compression.  
  60.  
  61.  
  62.  
  63.  
  64. Thu Jan 3 15:51:48 2002                                           Page 1
  65.  
  66.  
  67.  
  68.  
  69. NULIB2 (1L)                   17 Jan 2000                    NULIB2 (1L)
  70.  
  71.  
  72.  
  73.         ›1m-c›m Comments. When extracting, comments will  be  displayed.
  74.         When  adding,  you  will be prompted to enter a one-line comment
  75.         for every file.  
  76.  
  77.         ›1m-e›m Preserve ProDOS file types.  See the  ProDOS  File  Type
  78.         Preservation  document  on  http://www.nulib.com/ for details on
  79.         how this works.  
  80.  
  81.         ›1m-ee›m Preserve file types, using  extended  names.    A  file
  82.         extension is  appended  to extracted files.  Useful on operating
  83.         systems like Windows, where filename extensions  are  important.
  84.         When adding files, ›3mnulib2›m will try to guess at correct file 
  85.         types by examining the filename extension.  
  86.  
  87.         ›1m-f›m Freshen  files.   When adding, files in the archive that
  88.         are older than files on disk are "freshened",  meaning  that  no
  89.         new  files  are  added, and files that are the same age or newer
  90.         aren't touched.  Works similarly when extracting.  
  91.  
  92.         ›1m-j›m Junk directory names.  Only the filename  is  kept;  the
  93.         rest of  the  pathname is thrown away.  Empty directories aren't
  94.         stored.  Works when adding or extracting.  
  95.  
  96.         ›1m-k›m Store files as disk images.  Files that are  a  multiple
  97.         of  512  bytes  will  be added as disk images rather than normal
  98.         files.  This does not override the "-e" flag.  
  99.  
  100.         ›1m-l›m Auto-convert text files.  A reasonably  smart  algorithm
  101.         is used to identify which files are text and which aren't during 
  102.         extraction.   It  then  converts whatever EOL indicator is being
  103.         used by the text file into something appropriate for the current 
  104.         system.  
  105.  
  106.         ›1m-ll›m Auto-convert all files.  All files being extracted  are
  107.         considered text,  and  will be converted.  Don't use this unless
  108.         you're sure you need it.  
  109.  
  110.         ›1m-r›m Recurse into subdirectories.  When adding,  this  causes
  111.         ›3mnulib2›m  to descend into subdirectories and store all of the
  112.         files found.  When extracting, testing, or deleting, this causes 
  113.         the files listed to  match  against  all  records  whose  prefix
  114.         matches,  allowing  you  to  extract,  test,  or  delete  entire
  115.         subdirectories from the archive.  
  116.  
  117.         ›1m-u›m Update files.  When adding, files in  the  archive  that
  118.         are older  than files on disk are updated.  Files in the archive
  119.         that are the same age or newer aren't touched.  New  files  will
  120.         be added.  Works similarly when extracting.  
  121.  
  122. EXAMPLES  
  123.         A simple example: 
  124.  
  125.          
  126.                 nulib2 a foo.shk *›1m 
  127.  
  128.  
  129.  
  130. Thu Jan 3 15:51:48 2002                                           Page 2
  131.  
  132.  
  133.  
  134.  
  135. NULIB2 (1L)                   17 Jan 2000                    NULIB2 (1L)
  136.  
  137.  
  138.  
  139.         creates the archive ›3mfoo.shk›m (assuming it doesn't exist) and 
  140.         stores  all  of  the  files  in  the current directory in it, in
  141.         compressed form.  
  142.  
  143.         If you wanted to add all the files in the current directory,  as
  144.         well as all files in all subdirectories, you could use: 
  145.  
  146.          
  147.                 nulib2 ar foo.shk *›3m 
  148.  
  149.         to recursively descend into the directory tree.  
  150.  
  151.         Using the command: 
  152.  
  153.          
  154.                 nulib2 xe foo.shk›m 
  155.  
  156.         would  extract  all  files  from ›3mfoo.shk,›m preserving ProDOS
  157.         file types.  If you then used the command: 
  158.  
  159.          
  160.                 nulib2 aer foo.shk *›3m 
  161.  
  162.         you would add the files, preserving the file types  of  anything
  163.         that was extracted with the "-e" flag set.  
  164.  
  165.         A handy way to look at text documents is to use: 
  166.  
  167.          
  168.                 nulib2 xeel foo.shk›m 
  169.  
  170.         to  convert  end-of-line  terminators  (e.g.  CRLF to LF) as the
  171.         files are being extracted.  The "-ee" flag adds  ".TXT"  to  all
  172.         files with a ProDOS file type of TXT ($04).  
  173.  
  174. SEE ALSO  
  175.         compress(1), tar(1), zip(1L), unzip(1L), nulib(1L) 
  176.  
  177. BUGS  
  178.         Probably.  
  179.  
  180. AUTHOR  
  181.         Copyright (C) 2000 by Andy McFadden. All Rights Reserved.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. Thu Jan 3 15:51:48 2002                                           Page 3
  197.  
  198.  
  199.